4/17/24, 2:14 PM Creating a default community health file - GitHub Docs 


Creating a default community health file 


You can create default community health files, such as 
CONTRIBUTING and CODE_OF_CONDUCT. Default files will be 
used for any repository owned by the account that does not 
contain its own file of that type. 


In this article 


About default community health files 
Supported file types 


Creating a repository for default files 


About default community health files 


Default community health files are a set of predefined files that provide guidance and templates for 
maintaining a healthy and collaborative open source project. You can add default community health 
files to a public repository called .github , inthe root of the repository orinthe docs or .github 
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folders. These files help you automate and standardize various aspects of your project's 
development and community interaction. They are essential for promoting transparency, good 
practices, and collaboration in open source projects. 


O GitHub Docs Version: Free, Pro, & Team ~ Search GitHub Docs 


= Building communities / Healthy contributions / Community health file 


e The .github folder 
e The docs folder 


For example, anyone who creates an issue or pull request in a repository that does not have its own 
CONTRIBUTING file will see a link to the default CONTRIBUTING file. If a repository has any files in 

its own .github/ISSUE_TEMPLATE folder, including issue templates or a config.yml file, none of the 
contents of the default .github/ISSUE_TEMPLATE folder will be used. 


Default files won't appear in the file browser or Git history and are not included in clones, packages, 
or downloads of individual repositories because they are stored only in the .github repository. 


As a repository maintainer, you can use the community standards checklist to see if your project 
meets the recommended community standards to help people use and contribute to your project. 
For more information, see "About community profiles for public repositories." 


Supported file types 


You can create defaults in your organization or personal account for the following community health 
files: 
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Community health file 


CODE_OF_CONDUCT.md 


CONTRIBUTING.md 


Discussion category forms 


FUNDING. yml 


GOVERNANCE.md 


Issue and pull request templates and config.yml 
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Description 


A CODE_OF_CONDUCT file defines standards for 
how to engage in a community. For more information, 
see "Adding a code of conduct to your project." 


A CONTRIBUTING file communicates how people 
should contribute to your project. For more 
information, see "Setting guidelines for repository 
contributors." 


Discussion category forms customize the templates 
that are available for community members to use 
when they open new discussions in your repository. 
For more information, see "Creating discussion 
category forms." 


A FUNDING file displays a sponsor button in your 
repository to increase the visibility of funding options 
for your open source project. For more information, 
see "Displaying a sponsor button in your repository." 


A GOVERNANCE file lets people know about how 
your project is governed. For example, it might 
discuss project roles and how decisions are made. 


Issue and pull request templates customize and 
standardize the information you'd like contributors to 
include when they open issues and pull requests in 
your repository. For more information, see "About 


issue and pull request templates." 
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Community health file Description 


SECURITY.md A SECURITY file gives instructions on how to report a 
security vulnerability in your project and description 
that hyperlinks the file. For more information, see 
"Adding a security policy to your repository." 


SUPPORT.md A SUPPORT file lets people know about ways to get 
help with your project. For more information, see 
"Adding support resources to your project." 


You cannot create a default license file. License files must be added to individual repositories so 
the file will be included when a project is cloned, packaged, or downloaded. 


Creating a repository for default files 


In the upper-right corner of any page, select +, then click New repository. 
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in | New repository 


E4 Import repository 


© New codespace ssue 


<> New gist 


New organization 


2 Use the Owner drop-down menu, and select the organization or personal account you want to 
create default files for. 
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Owner * Repository name * 


© octocat ~ | 


emorable. Need inspiration? 
v © octocat 


® github 


In the "Repository name" field, type .github. 

Optionally, in the "Description" field, type a description. 

Make sure the repository status is set to Public. A repository for default files cannot be private. 
Select Initialize this repository with a README. 

Click Create repository. 


In the repository, create one of the supported community health files. Issue templates and their 
configuration file must be in a folder called .github/ISSUE_TEMPLATE . All other supported files 
may be in the root of the repository, the .github folder, or the docs folder. For more 
information, see "Creating new files." 
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